home *** CD-ROM | disk | FTP | other *** search
/ Delphi Magazine Collection 2001 / Delphi Magazine Collection 20001 (2001).iso / DISKS / Issue31 / hstr / HSTR.ZIP / README.TXT < prev   
Encoding:
Text File  |  1998-01-29  |  7.7 KB  |  186 lines

  1.                           *** HyperString v2.5 ***
  2.                 (c)1996-98 EFD Systems, All rights reserved
  3.                              efd@mindspring.com
  4.  
  5.                  *** THIS IS NOT PUBLIC DOMAIN SOFTWARE ***
  6.      See below for license agreement, disclaimer, installation and use.
  7.  
  8.  
  9.     Introduction ---------------------------------------------------------
  10.  
  11.     Welcome to HyperString!
  12.  
  13.     One of the most significant new features with Delphi32 is long dynamic
  14.     strings.  However, the built-in functions don't really reveal the full
  15.     potential of these new strings. HyperString provides over 250 fast,
  16.     efficient string management routines to help you realize the full power
  17.     of this highly versatile new data type.
  18.  
  19.  
  20.     Installation ---------------------------------------------------------
  21.  
  22.     Installation of the HyperString library is as easy as 1-2-3:
  23.  
  24.     1) Copy HYPERSTR.PAS (or the DCU) to your Delphi Library directory.
  25.        (..\DELPHI\LIB)
  26.  
  27.     2) Copy HYPERSTR.HLP and HYPERSTR.CNT to your Delphi Help directory.
  28.        (..\DELPHI\HELP)
  29.  
  30.     3) (Optional, but highly recommended) With minimal effort, the WinHelp
  31.        docs for HyperString can be seamlessly integrated into Delphi's
  32.        on-line Help for convenient access during coding.
  33.  
  34.        First, make a backup copy of ..\DELPHI\HELP\DELPHI.CNT (DELPHI3.CNT)
  35.  
  36.        Edit DELPHI.CNT (it's a simple text file) using NOTEPAD, WORDPAD or
  37.        the ASCII editor of your choice.  Insert 2 lines as follows based
  38.        on your version of Delphi (version 2 or 3).
  39.  
  40.        *** Delphi2 ***
  41.        --------------------------------------------------------------
  42.        Insert as Line #3   > :Index HyperString Library =hyperstr.hlp
  43.  
  44.        Insert as Last Line > :Include hyperstr.cnt
  45.        --------------------------------------------------------------
  46.  
  47.        *** Delphi3 ***
  48.        --------------------------------------------------------------
  49.        Insert in Index Section   > :Index HyperString Library =hyperstr.hlp
  50.        (near top of file)
  51.  
  52.        Insert in Include Section > :Include hyperstr.cnt
  53.        (near end of file)
  54.        --------------------------------------------------------------
  55.  
  56.  
  57.        The colons are to be added as part of each line. Once you've
  58.        finished editing, DELPHI.CNT should look something like this:
  59.  
  60.        --------------------------------------------------------------
  61.           :Base delphi.HLP>main
  62.           :Title Delphi Help
  63.           :Index HyperString Library =hyperstr.hlp
  64.                     .
  65.                     .
  66.                     .
  67.           :Include hyperstr.cnt
  68.  
  69.        --------------------------------------------------------------
  70.  
  71.        NOTE:
  72.  
  73.        Be sure to press [Enter] after typing the last line in the file.
  74.        WinHelp will sometimes ignore lines that are not terminated by a
  75.        CR/LF pair. In other words, the very last line in DELPHI.CNT should
  76.        appear to be an empty line as shown above.
  77.  
  78.        Save the file and you're done!
  79.  
  80.        The next time you access Delphi Help, you'll receive the message,
  81.  
  82.                    "Preparing Help files for first use"
  83.  
  84.        This indicates that WinHelp is rebuilding the Delphi Help indexes to
  85.        include HyperString. Once this is complete, you should see a new
  86.        entry for HyperString at the bottom of the Help Contents page and
  87.        entries for the HyperString routines should be in the Index.
  88.  
  89.  
  90.     Using HyperString ----------------------------------------------------
  91.  
  92.     HyperString is a non-visual library.  Once installed, simply add
  93.     'HyperStr' to the 'uses' clause of any unit where you intend to make
  94.     use of HyperString routines.
  95.  
  96.  
  97.     Ordering HyperString -------------------------------------------------
  98.  
  99.     After using HyperString, you may decide that you would like to purchase
  100.     a source code license (only $39US).  Currently there are 2 ways to order.
  101.  
  102.     1) From the World Wide Web.  Using a major credit and a secure link
  103.     from our web site at:
  104.  
  105.     http://www.mindspring.com/~efd
  106.  
  107.     Source code will be delivered to your e-mail address.
  108.  
  109.     2) By mail.  Send check (US banks only) or money order for $39US to:
  110.  
  111.     EFD Systems
  112.     304 Smokerise Circle
  113.     Marietta, GA 30067
  114.     USA
  115.  
  116.     Source code will be delivered via e-mail or ground carrier (our choice
  117.     of carrier) upon request.
  118.  
  119.  
  120.     UnInstall ------------------------------------------------------------
  121.  
  122.     Should you decide that HyperString is not for you (unlikely but
  123.     possible <g>), delete the 3 files mentioned above.  If you modified
  124.     DELPHI.CNT, simply re-edit the file and delete the 2 lines that were
  125.     added or better yet, overwrite the file with the backup copy.
  126.  
  127.  
  128.     License Agreement and Disclaimer -------------------------------------
  129.  
  130.     By using this product, you indicate your understanding and acceptance
  131.     of the terms and conditions below.
  132.  
  133.     This software (the product) is copyright 1996-98, EFD Systems, all
  134.     rights reserved. Except as detailed herein, you (the user) are granted
  135.     a license to use this software without payment of fees.  You may
  136.     distribute the non-source code version of this product for similar use
  137.     by others, provided that no fees are charged and the software is
  138.     distributed in it's entirety as originally released, including this
  139.     documentation file.
  140.  
  141.     HyperString is a development tool intended to assist software authors
  142.     in the creation of original works. As such, software authored by you
  143.     with the assistance of this product (your product) may be freely
  144.     distributed except as follows:
  145.  
  146.     1)  HyperString source code and derivatives thereof may not be
  147.         re-distributed under any circumstances.  If you are working as a
  148.         contractor or programmer for hire, your client/employer must
  149.         purchase a source code license under the terms of this agreement in
  150.         order to receive the HyperString source code.
  151.  
  152.     2)  Your product must not represent a simple re-packaging of some or
  153.         all of this product.  HyperString may not be used to produce
  154.         similar or competing products.
  155.  
  156.     3)  A source code license is required in order to use this product in
  157.         the production of any development tool or component which will be
  158.         licensed or sold for gain or profit.  As you ask of others, we ask
  159.         of you.
  160.  
  161.     Except as noted above, a source code license grants the user the
  162.     non-exclusive, non-transferable right to view and use the source as
  163.     desired to produce compiled, machine readable and executable object
  164.     code.  The source code remains the exclusive, proprietary property of
  165.     EFD Systems. The right to suspend the terms of this agreement upon
  166.     refund of license fee is retained by EFD Systems.
  167.  
  168.     THIS SOFTWARE IS PROVIDED SOLELY AS-IS AND WITHOUT WARRANTY INCLUDING
  169.     WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR
  170.     FITNESS FOR A PARTICULAR PURPOSE.  THE USER AGREES TO INDEMNIFY AND
  171.     HOLD THE AUTHOR HARMLESS FROM AND AGAINST ANY AND ALL CLAIMS ARISING
  172.     FROM OR RELATED TO USE OF THE PRODUCT. UNDER NO CIRCUMSTANCES SHALL THE
  173.     AUTHOR'S LIABILITY EXCEED THE SOFTWARE LICENSE FEE.
  174.  
  175.     By using this product, you indicate your understanding and acceptance
  176.     of the terms and conditions above.
  177.  
  178.  
  179.     Revision History -----------------------------------------------------
  180.  
  181.     v1.0 - 96/12/25, Original release (Happy holidays).
  182.     v1.5 - 97/06/01, Many new routines, instructions for Delphi 3.
  183.     v2.0 - 97/08/01, Added dynamic arrays and other new features.
  184.     v2.2 - 97/12/15, Revised dynamic arrays, more new features.
  185.     v2.5 - 98/01/30, Bigger and better than ever!
  186.